.TH STEGIT-2 1 2010-10-22 "stegit-2" "StegIT-2 User's Manual"
.SH NAME
stegit-2 \- A multipurpose framework for audio steganography (OSE version)
.SH SYNOPSIS
.BI "stegit-2 [-di] [-c " "config-file" " ] [-E " "embedding-domain" " ] [-b " "bit-source" " ] [-p " "protocol-layer" " ] [-r " "embedding-source" " ] [-w " "embedding-destination" " ] [-R " "extraction-source" " ] [-W " "extraction-destination" " ] [-1 " "read-embed-wav-file" " ] [-2 " "write-embed-wav-file" " ] [-3 " "read-extract-wav-file" " ] [-4 " "write-extract-wav-file" " ] [-s " "buffer-size" " ] [-D " "discard-time" " ] [-O " "samples" " ] [-e " "SECTION::KEY=value" " ]"
.br
.SH DESCRIPTION
Stegit-2 is used for embedding and extraction of secret data using audio data as
cover media. The cover media can be WAV files, a VoIP connection, a virtual
(socket) connection or an interface to the computer soundcard via ALSA or
Pulseaudio.

.SS OPTIONS
.TP
.IP -d
Disable embedding and extraction. This option is only relevant for testing.
.IP -i
When working with WAV files, this option activates looping of the file
contents.
.IP "-c config-file"
Use the alternate
.I config-file
instead of
.IR /etc/stegit-2/stegit-2.conf .
.IP "-E embedding-domain"
Specifies the domain of embedding. This overrides the key
.B FACTORY::EMBEDDING_ENGINE
from the config-file. Available parameters for
.I embedding-domain
and their corresponding config-file values are: 
.RS
.IP l
LSB
.IP r
LSB_RAND
.IP e
ECHO
.IP s
SPREAD_SPECTRUM
.IP d
DYNAMIC_SS
.IP p
PHASE
.IP i
DIFF
.IP a
CRYPTO - AMPLITUDE_SCRAMBLING
.IP A
CRYPTO - ADV_AMPLITUDE_SCRAMBLING
.IP f
CRYPTO - FREQUENCY_PERMUTATION_SCRAMBLING
.IP c
CRYPTO - NULL_CIPHER
.IP x
DEFENSE
.RE
.IP "-b bit-source"
Specifies the bit-source implementation. This overrides the key
.B FACTORY::BIT_SOURCE
from the config-file. Available parameters for
.I bit-source
and their corresponding config-file values are:
.RS
.IP b
BYTE_BUILDER
.IP f
FRAME_BUILDER
.IP s
STREAM_BUILDER
.RE
.IP "-p protocol-layer"
Specifies the protocol implementation. This overrides the key
.B FACTORY::PROTOCOL_ENGINE
from the config-file. Available parameters for
.I protocol-layer
and their corresponding config-file values are:
.RS
.IP f
FILE
.IP s
SIMPLEFILE
.IP g
GUI
.RE
.IP "-r embedding-source"
Specifies the I/O device or file from which the cover media is read for
embedding. Available parameters for
.I embedding-source
are:
.RS
.IP wm
Mono WAV file
.IP a
ALSA sound subsystem
.IP p
Pulseaudio sound subsystem
.IP r
Routing, uses the
.B libnetfilter-queue
to manipulate VoIP packets
.IP s
Virtual socket connection
.RE
.IP "-w embedding-destination"
Specifies the I/O device or file to which the stego-object (modified cover media
after embedding) is written at the sender. Available parameters for
.I embedding-destination
are the same as for the
.B -r
Option.
.IP "-R extraction-source"
Specifies the I/O device or file from which the stego-object is read at the
receiver. Available parameters for
.I extraction-source
are the same as for the
.B -r
Option.
.IP "-W extraction-destination"
Specifies the I/O device or file to which the audio data (eventually modified
stego-object after extraction) is written. Available
parameters for
.I extraction-destination
are the same as for the
.B -r
Option.
.IP "-1 read-embed-wav-file"
WAV file which is taken for embedding. Only relevant in conjunction with the
.B "-r wm"
option. For all other parameters of
.I embedding-source
this option is ignored.
.IP "-2 write-embed-wav-file"
WAV file to which the stego-object is written at the sender. Only relevant in
conjunction with the
.B "-w wm"
option. For all other parameters of
.I embedding-destination
this option is ignored.
.IP "-3 read-extract-wav-file"
WAV file which is taken for extraction at the receiver. Only relevant in
conjunction with the
.B "-R wm"
option. For all other parameters of
.I extraction-source
this option is ignored.
.IP "-4 write-extract-wav-file"
WAV file to which the audio data is written. Only relevant in conjunction with
the
.B "-W wm"
option. For all other parameters of
.I extraction-destination
this option is ignored.
.IP "-s buffer-size"
Specifies the length of the buffer used for extraction in asynchrone mode.
.I buffer-size
is given in
.SM MB
as integer value. Only relevant in conjunction with the
.B "-R"
and
.B "-W"
options (extraction).
.IP "-D discard-time"
Specifies an amount of time which is ignored at the beginning of a given WAV
output file.
.I discard-time
is given in ms. Only relevant when mono WAV files are used.
.IP "-O samples"
Algorithm dependent, supported by
.B DYNAMIC_SS
and
.B DIFF
embedding domains at extraction. Overwrites the values for
.B DYNAMIC_SS::FREQ_OMIT_SAMPLES
and
.B DIFF::OMIT_SAMPLES.
.IP "-e SECTION::KEY=value"
Changes the key
.B KEY
from the section
.B SECTION
of the config-file to the new value
.I value.

\" .SH NOTES

.SH FILES
.I /etc/stegit-2/stegit-2.conf
.RS
The global config file, used when no
.B -c
option is specified.
.RE
.I /tmp/read.dat
.RS
The secret data source when using
.B file-protocol-engine
or
.B simplefile-protocol-engine.
.RE
.I /tmp/write.dat
.RS
The secret data sink when using
.B file-protocol-engine
or
.B simplefile-protocol-engine.

.SH EXAMPLES
Embedding, WAV file to WAV file (reads from
.I /tmp/read.dat
):
.RS
stegit-2 -c /tmp/stegit-2.conf -E d -b b -p s -r wm -w wm -1 cover.wav -2
stego-object.wav
.RE

Extraction from WAV file (writes to
.I /tmp/write.dat
):
.RS
stegit-2 -c /tmp/stegit-2.conf -E d -b b -p s -s 10 -O 122 -R wm -W wm -3
stego-object.wav -4 out.wav
.RE

Communication over virtual connection, using WAV files as input and Pulseaudio
as output device (Sender):
.RS
stegit-2 -E d -b s -p g -i -r wm -w s -R s -W p -1 cover.wav -e
SOCKET_IO::SERVER=true -e USER_INTERFACE::ACTIVE=true -e
USER_INTERFACE::PORT=8960
.RE

Communication over virtual connection, using WAV files as input and Pulseaudio
as output device (Receiver):
.RS
stegit-2 -E d -b s -p g -i -r wm -w s -R s -W p -1 cover.wav -e
SOCKET_IO::SERVER=false -e USER_INTERFACE::ACTIVE=true -e
USER_INTERFACE::PORT=8966
.RE

.SH AUTHOR
Concepts, software, and man page written by the StegIT-2 project team.

\" .SH "SEE ALSO"

\" .SH COPYRIGHT

